home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / SNEWS351.ZIP / SICKNEWS.DOC < prev    next >
Text File  |  1995-11-14  |  14KB  |  349 lines
  1. Program        : SickNews.
  2. Version Number : 3.51.
  3. Release Date   : 15/11/1995.
  4.  
  5. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  6.                         Contents of this Document
  7. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  8.  
  9.                         - What is Sicknews?
  10.                         - Disclaimer
  11.                         - Files in the archive
  12.                        -- Installing Sicknews.
  13.                         - Format of SICKNEWS.TXT.
  14.                         - Configuring Sicknews.
  15.                         - The Defineable Headers.
  16.                         - Color Codes.
  17.                         - The Kewl Colors.
  18.                         - Trouble Shooting.
  19.                         - Registration.
  20.                         - Creditz and Greetz.
  21.  
  22. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  23.                              What is Sicknews?
  24. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  25.  
  26.  Sicknews is a utility that can create customised ANSi, ASCii, and PCB News
  27.  files simply using a text editor. Unlike most news programs, Sicknews is
  28.  totally 100% configurable.
  29.  
  30. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  31.                                 Disclaimer
  32. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  33.  
  34.  I truly cant see anyway this program can fuck up your equipment, but if
  35.  something bad does happen, neither Flax or SiCK will take any responsibility
  36.  for the damage. Use at own risk.
  37.  
  38. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  39.                             Installing Sicknews
  40. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  41.  
  42.  ─ Unzip the archive into a directory. I guess you've already done this eh.
  43.  
  44.  ─ Run NEWSCFG.EXE to install and configure Sicknews. See "Configuring-
  45.    Sicknews" for details on the configuration.
  46.  
  47.  ─ Create a file called SICKNEWS.TXT. See "Format of SICKNEWS.TXT".
  48.  
  49.  ─ Run Sicknews.EXE.
  50.  
  51. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  52.                           Format of SICKNEWS.TXT
  53. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  54.  
  55.  [ There is a sample text file included in this archive, called SAMPLE.TXT ]
  56.  
  57. - Format of SICKNEWS.TXT:
  58.  
  59.  DATE     -- Date of the Bulletin.
  60.  TiTLE    -- Title of the Bulletin.
  61.  BULLETIN -- Your News Text. This can be an unlimited amount of lines.
  62.  ***      -- FINISH EACH ENTRY WITH "***".
  63.  
  64. - Example of SICKNEWS.TXT
  65.  
  66. █  01/01/95
  67. █  FiDONET!
  68. ▓  We have just joined up to FidoNet. FidoNet is blah blah blah...
  69. ▓  Leave a message to Flax if you have any questions.
  70. ▒  ***
  71. ▒  02/01/95
  72. ░  D0H.
  73. ░  We have been kicked out of Fidonet.
  74. ░  ***
  75.  
  76.  REMEMBER: You can Remark lines in your SICKNEWS.TXT file (make them exempt
  77.  from the output files) by beginning a line with ";".
  78.  
  79.  Eg. "; This line would not be in the output files"
  80.  
  81. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  82.                            Configuring Sicknews
  83. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  84.  
  85.    MAiN
  86.  █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  87.  ▌ Save and Exit       -- Exit NEWSCFG and Save Changes.
  88.  ▌ Save Without Exit   -- Save Changes without Exiting NEWSCFG.
  89.  ▌ Exit Without Save   -- Exit NEWSCFG without Saving any Changes.
  90.  ▌ Program Information -- Information on SickNews.
  91.  ▌ Info on SiCk        -- Information on Art/Coding group SiCk.
  92.  ▀
  93.  
  94.    PATHS
  95.  █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  96.  ▌ Path To ANSi Output -- Path And FileName of your ANSi News File.
  97.  ▌ Path To PCB Output  -- Path And FileName of your PCB News File.
  98.  ▌ Path To ASCii Output-- Path And FileName of your ASCii News File.
  99.  ▀
  100.    N0TE: -If these are set to a PATH only, Eg. "C:\RA\TXTFILES\", then
  101.           SickNews will create C:\RA\TXTFILES\SICKNEWS.ext.
  102.  
  103.          -If these options are Empty, iE. they are set to Nothing,
  104.           SickNews will create the output files in the CURRENT directory.
  105.  
  106.          -The files are only created if the corresponding options in
  107.           NEWSCFG > TOGGLES are set to "YES".
  108.    
  109.    STRiNGS
  110.  █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  111.  ▌ Hit Enter String  -- Eg. "Hit Enter To Continue...".
  112.  ▀                      Use [CTRL-A] for a Smiley face thingo.
  113.                         PCB users should use @MORE@.
  114.         
  115.    TOGGLES
  116.  █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  117.  ▌ ANSi        -- Should Sicknews Create the ANSi News File?
  118.  ▌ ASCii       -- Should Sicknews Create the ASCii News File?
  119.  ▌ PCB         -- Should Sicknews Create the PCB News File?
  120.  ▌ Add Header  -- If Set to YES, Sicknews will add the news header to the top
  121.  ▌                of your News file [the default header or the external file].
  122.  ▌ Wait        -- If set to YES, Sicknews will add your "Hit Enter String"
  123.  ▌                after each bulletin.
  124.  ▌ Clear1      -- If set to YES, the screen will clear before your news file
  125.  ▌                begins displaying.
  126.  ▌ Clear2      -- If set to YES, the screen will clear before each bulletin.
  127.  ▌                it begins displaying.
  128.  ▌ Kewl Color  -- Please See "The Kewl Colors" for details on this format of
  129.  ▀                display.
  130.  
  131.    COLOURS
  132.  █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  133.  ▌ News Text      --  Default color of your news Text. Your news Text
  134.  ▌                    can also change colour with Sicknews Color Codes
  135.  ▌                    (see "Color Codes" for more info).
  136.  ▌ Hit Enter      --  Default colour of your "Hit Enter" String. This can also
  137.  ▌                    be changed with Sicknews Colour Codes.
  138.  ▌ UpperCase
  139.  ▌ LowerCase
  140.  ▌ Punctuation    -- These come into effect when Kewl Color is set to YES,
  141.  ▌ Hibit ASCii       and affect only your News Text.
  142.  ▌ Numbers
  143.  ▌
  144.  ▌ Default Colours-- Set all colours to their defaults.
  145.  ▀ 
  146.  
  147.   OTHER
  148.  █▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  149.  ▌ Sysop Name
  150.  ▌ BBS Name
  151.  ▌ Register Code -- Leave as 0 if Sicknews is Unregistered.
  152.  ▌ Indentation   -- How many spaces to indent your News Text.
  153.  ▌ Empty Lines   -- Number of empty lines to add to the end of each bulletin.
  154.  ▌ Max Amount    -- The maximum amount of bulletins you want sicknews to
  155.  ▀                  process.
  156.  
  157. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  158.                           The Defineable Headers
  159. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  160.  
  161.    [ NOTE: ".???" represents the extensions ".ANS", ".ASC" and ".PCB" ]
  162.  
  163.  IF THE FILES "S-HDR.???" AND "S-BUL.???" ARE NOT PRESENT, SICKNEWS USES A
  164.  DEFAULT NEWS AND BULLETIN HEADER. YOU DO NOT HAVE TO CREATE THESE FILES.
  165.  
  166.  S-HDR.??? and S-BUL.??? are two External Files which you can create to make
  167.  Sicknews fit in more comfortably with your system.
  168.  
  169.  You can create these files using a standard ANSi Editor.
  170.  
  171.  
  172.   S-HDR.ANS/ASC/PCB: This file is displayed at the very top of the News File.
  173.                      Inside it you can include:
  174.  
  175.  ░  #######  Sicknews will replace these codes with the Total Amount of
  176.  ░           Bulletins in the SickNews.TXT file.
  177.  
  178.  
  179.  S-BUL.ANS/ASC/PCB: This file is displayed at the beginning of each bulletin.
  180.                     Inside it you can include:
  181.  
  182.  █  ///////  These codes are replaced with the DATE which was
  183.  █           entered into SICKNEWS.TXT for each Bulletin.
  184.  █
  185.  ▓  \\\\\\\  These codes are replaced with the TITLE which was
  186.  ▓           entered into SICKNEWS.TXT for each Bulletin.
  187.  ▓
  188.  ▒  !!!!!!!  These codes are replaced with the Current Bulletin
  189.  ▒           Number. Eg. The First bulletin would replace these codes with
  190.  ▒           a number 1, second with a 2 etc.
  191.  ▒
  192.  ░  #######  These codes are replaced with the Total Amount of
  193.  ░           Bulletins in the SickNews.TXT file.
  194.  ░
  195.  
  196.    NOTE: Sicknews will LEFT JUSTIFY both the "!!" codes and the "##" codes.
  197.          Ie. In the third bulletin of ten, "!!!! of ####"
  198.          ... would produce the output:     "3    of 10  "
  199.  
  200.   -There is no limit on how many of these codes you can put into S-BUL.???.
  201.  
  202.   -You do NOT need to make the codes the same colour. ie. This is valid:
  203.  
  204.    Red Yellow   Blue  Cyan                     White
  205.   ┌─┴─┐┌──┴──┐  ┌─┴─┐┌──┴──┐┌────────────────────┴─────────────────────┐
  206.   ////////////  \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
  207.  
  208.    -The Codes do not need to be on the same line. ie.This is valid:
  209.  
  210.         Title: \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\  Date: ////////
  211.                \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\  Bulletin Number: !!
  212.                \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\  Total Bulletins: ##
  213.  
  214.    -Remember NOT to save the files with a "ClearScreen" Video Preparation,
  215.     especially the S-BUL.??? file(s).
  216.  
  217.    -Some Samples of S-HDR.??? and S-BUL.??? are included in SAMPLES.ZIP.
  218.  
  219.   NOTE TO ARTiSTS: Feel free to collate your headers and distribute them..
  220.  
  221. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  222.                                Color Codes
  223. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  224.  
  225.  Using Sicknews Color Codes, you can change the color of your news text.
  226.  
  227.  COLOUR CODE =  "|" + [BACKGROUNDCOLOUR] + [FOREGROUNDCOLOUR].
  228.  
  229.  Here's a List of the Sicknews Color Codes:
  230.  
  231.  -------- FOREGROUND COLOURS:
  232.  
  233.  █    0  Black Foreground.       8  Dark Grey.
  234.  █    1  Dark Blue.              9  Blue.
  235.  █    2  Dark Green.             A  Light Green.
  236.  █    3  Cyan.                   B  Light Blue.
  237.  ▓    4  Red.                    C  Light Red.
  238.  ▓    5  Deep Purple.            D  Light Magenta.
  239.  ▓    6  Brown.                  E  Yellow.
  240.  ▒    7  Light Grey.             F  Bright White.
  241.  ▒
  242.  ▒    !  = Default Foreground Color as defined in NEWSCFG.
  243.  ░    +  = Turns Brightness ON,  without changing the color.
  244.  ░    -  = Turns Brightness OFF, without changing the color.
  245.  ░    X  = No change.
  246.  
  247.  -------- BACKGROUND COLOURS:  [BG=Background,FG=Foreground]
  248.  
  249.  █    0  Black  BackGround.      8  Black  BG + FLASHING Foreground.
  250.  █    1  Blue   BG.              9  Blue   BG + FLASHING FG.
  251.  █    2  Green  BG.              A  Green  BG + FLASHING FG.
  252.  ▓    3  Cyan   BG.              B  Cyan   BG + FLASHING FG.
  253.  ▓    4  Red    BG.              C  Red    BG + FLASHING FG.
  254.  ▓    5  Purple BG.              D  Purple BG + FLASHING FG.
  255.  ▒    6  Brown  BG.              E  Brown  BG + FLASHING FG.
  256.  ▒    7  Grey   BG.              F  Grey   BG + FLASHING FG.
  257.  ▒
  258.  ▒    !  = Default Background Color as defined in NEWSCFG.
  259.  ░    +  = Turns FLASHING ON,  without changing the color.
  260.  ░    -  = Turns FLASHING OFF, without changing the color.
  261.  ░    X  = No change.
  262.  
  263.   So to return to the DEFAULT Background and Foreground colour, [ which are
  264.   defined in NEWSCFG > Colours > News Text ], the colour code would be |!!
  265.  
  266.  
  267.  For example; A line such as this in your message text:
  268.  
  269.                "|0DHeaps of |03WiCKEDASS |!!options!!!"
  270.  
  271.  .. will come out as such..
  272.  
  273.                 Heaps of WiCKEDASS options!!!
  274.                 └┬──────┘└┬───────┘└┬───────┘
  275.                 Magenta  Cyan      Default News Text Colour
  276.   
  277.  
  278.   ------- IMPORTANT N0TE:
  279.  
  280.   Color Codes are removed when writing to the ASCii file.
  281.   ie. "|0FL|0A8|07r|08!" would be written to the ASCii file as "L8r!".
  282.  
  283.   .. the color codes are also removed when you have enabled the KEWL COLORS
  284.   feature.
  285.  
  286. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  287.                              The Kewl Colors {+}
  288. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  289.  
  290.  You have the ability to disregard all Color Codes and display the news text
  291.  in your output ANSi/PCB files in "Kewl" colors, ie. the color of Uppercase
  292.  letters can be different to the colour of the lower case letters, etc.
  293.  
  294. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  295.                               Trouble Shooting
  296. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  297.  
  298.  ░ -Ive set Clear2 to "NO" but the news file seems to be clearing the screen
  299.  ░ after each bulletin.
  300.  
  301.  ** Reason: You have probably saved your S-BUL.??? file with a Clear Screen
  302.             video preparation.
  303.  ** Remedy: Save your S-BUL.??? file in your ansi editor with NO video
  304.             preparation.
  305.  
  306. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  307.                                Registration
  308. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  309.  
  310.   -( After registering you will have no "-UNREGiSTERED-" line anywhere )-
  311.  
  312.   Sicknews is FREE. There are 2 ways to register:
  313.  
  314.   1. Call the SiCk WHq, and select "Register Sicknews" from the logon matrix.
  315.   2. E-Mail flax@jeack.apana.org.au.
  316.  
  317.   Either way you will need to give me:
  318.  
  319.   -Sysop Name     (As in NEWSCFG)
  320.   -BBS Name       (As in NEWSCFG)
  321.  
  322.   And Optionally:
  323.  
  324.   -Comment about this program, you hate it, you love it, whatever
  325.   -If you've found any bugs, please report them.
  326.  
  327.  
  328.              tHE pSYCHOTIC bBS - +613-571-7456 - SiCk WHQ
  329.  
  330.  
  331.  TiP: A code can be entered while in NEWSCFG, whereby a registration key is
  332.  calculated and automatically entered into your configuration. I wonder if
  333.  you kiddies can work it out...
  334.  
  335. - -─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ --─░-░-─-∙-∙─∙─-─-─-░─░──∙∙∙─∙─∙──░-─ -
  336.                              Creditz and Greets
  337. - -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙──-─--─ -░-- -░-∙∙-─∙-─-∙─░-░-─-─-─∙─∙─∙──-─--─ -░-
  338.  
  339.  Coding, Docs - FLAX [SiCk]
  340.  FILE_ID.DIZ  - WOJ  [SiCk]
  341.  
  342.  [Special Greets]
  343.  
  344.    blade - sorry this took so long :)
  345.  cactoid - dewd!
  346.   vejita - I hear AV are after you.
  347.  
  348.  To everyone who is not french : Enjoy!
  349.